Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Utility Functions for Video Channel Callback Functions

SGTransferFrameForCompress

The SGTransferFrameForCompress function provides the default behavior for your transfer-frame function.

pascal ComponentResult SGTransferFrameForCompress (SGChannel c,
                                             short bufferNum,
                                             MatrixRecord *mp,
                                             RgnHandle clipRgn);

c

Specifies the reference that identifies the channel for this operation. The sequence grabber component provides this value to your transfer-frame function.

bufferNum

Identifies the buffer. The sequence grabber component provides this value to your transfer-frame function.

mp

Contains a pointer to a transformation matrix for the transfer operation. If there is no matrix for the operation, set this parameter to nil.

clipRgn

Contains a handle to the clipping region for the destination image. This region is defined in the destination coordinate system. If there is no clipping region, set this parameter to nil.

SPECIAL CONSIDERATIONS

You should call the SGTransferFrameForCompress function only from your transfer-frame function. If you call it at any other time, results are unpredictable.

RESULT CODE

cantDoThatInCurrentMode

-9402

Request invalid in current mode

SEE ALSO

See "Application-Defined Functions," which begins on page 5-107, for information about transfer-frame functions.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help